Gravity Forms v1.6.4 Beta 1 is now available. We are excited about this release because it introduces a new feature that has been heavily requested: field calculations. This release also introduces a new Gravity Forms shortcode that can be used to do conditional logic in the message of email notifications as well as in the confirmation text message to conditionally display content to the user based on field selections they made when submitting the form.
We can't wait to receive feedback from users who want to help us test out the new features. Please provide beta feedback and bug reports on the Support Forum and make it clear you are referring to the 1.6.4 Beta 1 release when doing so. Thanks!
We will be releasing v1.6.4 via automatic upgrade once it has undergone beta testing. Own Gravity Forms and want to give it a try and help us test? Grab a copy on the downloads page! Want a rundown of what is new in Gravity Forms v1.6.4? Keep reading!
Field Calculations
Calculation capabilities have been added to both the Number Field and the Product Field. This new functionality allows you to dynamically generate the value of a Number Field or the price of a Product Field based on a custom calculation using a formula you control.
This is a powerful new feature that gives you more control over how the value of a Number Field or Product pricing is calculated. It can be used in a variety of creative ways without the need to write custom PHP or implement custom jQuery. It's built right in and anybody can put it to use by using the built in user interface for building the formula that determines the calculation that will be performed.
The calculation formula builder allows you to customize the formula that is used to perform the calculation using available form merge tags. The calculation will then be performed automatically as users fill out your form and will again be executed when the form is submitted to ensure accuracy.
The Calculation functionality has been added to the following fields:
- Number Field You can enable calculations on the Number Field so that the value of the Number Field is determined by calculation using the formula you configure.
- Product Field A new Field Type has been added to the Product Field called Calculation. When a Product Field is configured as a Calculation it behaves like a Single Product field, however the Price is determined by calculation using the formula you configure.
Conditional Shortcode
Using the new conditional shortcode you can now perform conditional logic in the message content of your Admin and User Notification emails as well as the Confirmation Message that is displayed when a form is submitted.
This shortcode allows you to control the content of the email that is sent as well as the content of the confirmation message that is displayed when a form is submitted based on selections a user makes when submitting the form.
It's easy to use, simply wrap the content you wish to display conditionally in the conditional shortcode and configure the shortcode settings. Conditional logic will then be performed to determine if that content should be displayed when the email notification is sent or the confirmation message is displayed.
The Conditional Shortcode functionality can be used in the following locations:
- Admin Notification Message Use the conditional shortcode to conditionally output content within the admin notification message based on input and selections made by the user submitting the form.
- User Notification Message Use the conditional shortcode to conditionally output content within the user notification message based on input and selections made by the user submitting the form.
- Confirmation Message Text Use the conditional shortcode to conditionally output content within the confirmation message text displayed when the form is submitted.
Documentation for the new conditional shortcode is available here
Admin Notification Routing Enhancement
The Routing option for the Admin Notifications has been updated to support the enhanced conditional logic functionality introduced in Gravity Forms v1.6.3. You can now configure routing to use a variety of field types and enhanced conditions such as greater than, less than, contains, starts with, and ends with when performing a conditional statement.
Product Field Merge Tag Enhancements
We have enhanced the merge tag options for drop down and radio button Product Fields to support returning the quantity of that field. The quantity can be returned by appending :qty to the merge tag used for that field. For example: {My Product Field:1:qty} would return the quantity selected.
We have also enhanced the merge tag for the Total Field to support returning only the numeric value of the total. Previously the Total Field merge tag would always output the total price formatted as currency. Now you can append :price to the merge tag and it will return just the numeric value of the Total. For example: If the total is $10.50, the merge tag {Total:1:price} would return 10.50 instead of $10.50. This is useful for developers integrating with 3rd parties.
Other Fixes and Enhancements
- Added Calculation support to Number Field.
- Added Calculation support to Product Field.
- Added Conditional shortcode.
- Added enhanced conditional logic to Admin Notification Routing.
- Added support for showing lead on entry detail when LID or POS are passed.
- Added gform_recaptcha_init_script filter to allow custom changes to the recaptcha init.
- Added gform_entry_page_size hook to allow users to specify the page size on the entry list page.
- Added support for {Total:1:price} merge tag to allow total to be formatted numerically.
- Added support for {Product Name:1:qty} merge tag to allow the quantity of product fields to be returned via a merge tag.
- Updated inline js so that it is now "enqueued" and consolidated into a single script block tied to the 'gform_post_render' event.
- Updated notification wysiwyg styles in admin.
- Updated the form editor so that the max characters option on single input field is hidden when input mask is enabled.
- Updated checkbox field so that it can be pre-populated using an array in addition to a comma separated list.
- Fixed issue with {all_fields} merge tag when using post category fields as target of conditional logic.
- Fixed notice for $read_only variable.
- Fixed notice for postStatus.
- Fixed issue with form editor not allowing users to uncheck the "Set as Post Image" checkbox.
- Fixed issue where errors would be displayed when a "starts with" conditional logic was configured without the actual "starts with" value.
- Fixed issue with quantity field being recorded as . when a value is not entered.
- Fixed issue with a "Select Format" option appearing in the quantity field's number format option for newly created fields.
- Fixed admin display issue with the bulk-add modal panel in Chrome.
- Fixed warnings when nl2br used on array.
Please note that documentation for these new items is in progress.
Started using the 1.6.4 beta. Could use some examples in the calculation field. Is there a page on the site that has some samples... say a simple addition of 3 pricing or number fields that produces a subtotal on the form BEFORE it is submitted ? Some simple examples on how to properly use the syntax ? I am brand new to GF as you can tell from my subscription date.. 🙂
tnx / John ( Developer License )
The documentation for the Calculation functionality is not done which is why there are no examples for it in the Documentation. However, the screenshot that appears with the information about the Calculations above does show a real example of a simple calculation. The example in that screenshot shows a Number field with calculations enabled and the value of the number field will be calculated by adding the value of the Number 1 field with the value of the Number 2 field.
You create the formula for the calculation you want to perform using the provided UI. You use the Insert Merge Tag drop down to insert merge tags for the fields you want to be part of the calculation. You then use the buttons for the available operators (+, -, *, etc.) to help build your formula. When creating your formula you wouldn't include the =. It's assumed that the value will be whatever the result of the calculation is and it's automatically handled.
The calculation will be performed on the form using jQuery as the user fills out the fields on the form. The calculation will be performed again, on the server side, when the form is submitted to ensure that there was no manipulation of the calculation data through the use of a javascript code inspector, etc.
This is exactly what i needed. I just need to know, can I upgrade to this without losing my current forms and entries?
If yes, How?
Yes. You can upgrade to the v1.6.4 Beta 1 release without losing your current forms and entries. However, you must upgrade manually as this is a beta release so it has not been released via automatic update yet.
To manually upgrade follow these instructions:
- Download Gravity Forms v1.6.4 Beta 1 from the Download Gravity Forms page
- Login to the WordPress Dashboard for the site you want to upgrade
- Go to the Plugins admin page that lists all of your plugins
- Deactivate Gravity Forms
- Delete Gravity Forms
- Go to Add New under Plugins
- Select Upload
- Upload Gravity Forms v1.6.4 Beta 1
- Activate Gravity Forms
The process is similar to installing Gravity Forms for the first time only you would first need to deactivate and delete the version of Gravity Forms currently running on your site. Doing so will not delete your forms or entries. Those are stored in your database. Enjoy!
Deleting Gravity Forms won't delete the data?
Deleting Gravity Forms from the Plugin page in WordPress that lists all of your plugins and allows you to activate or deactivate your plugins will NOT delete your data. It only deletes the plugin files. Your form and entry data is stored in your WordPress database.
The only way to delete your data is to click on the UNINSTALL button that is on the Settings page of Gravity Forms. That WILL delete your Gravity Forms data. So never use that unless you really want to completely remove Gravity Forms and delete all of your form and entry data.
As for how to get the merge tag for calculations... you use the "Insert Merge Tag" drop down that is part of the calculation interface. If you don't see the fields you want to use in the "Insert Merge Tag" drop down it's because the fields must be new and the values in that drop down haven't been updated. If that is the case, simply save your form and then continue editing and the new fields should now be available in the "Insert Merge Tag" drop down.
oh just read your last paragraph. ok Thanks!!!
I don't understand how to get the merge tag number
Ah. I get it now. Works like a charm. Thanks!
hi
Seem like a great upgrade.
Will wait for full release, but a few questions.
Can you have ?
"if" and "else" commands?
Show field if A>B ?
Thanks
Mark
This is exactly what i needed right now! Thanks
Hi, I'm having trouble getting the calculation to work. Could you please help. Here is my page: http://www.weathertightrewards.com/calculator-test/
This is the calculation I'm using {Peak With 14 Day Notice (Quantity):7.3} * {15} to get whatever a user enters in Peak Without 14 Day Notice quantity to multiply x 15 and show the total.
@markjones Gravity Forms conditional logic does support greater than and less than type operators but it does not currently support "if...else" type functionality in the conditional logic. Right now if it's either If ALL conditions are met show/hide the field OR If ANY conditions are met show/hide the field.
@weathertight Looking at the calculation you are performing, what exactly is {15}? It's not a valid Gravity forms merge tag. Only merge tags should be displayed within the curly brackets like that.
If what you are trying to do is multiple the quantity of one of your product fields by 15, then you would do this:
{Peak With 14 Day Notice (Quantity):7.3} * 15
Hi
Thanks Carl,
Great upgrade, great plugin.
any idea of full release date?
Mark
Hi Carl,
I have just installed the beta after trying to figure out how to show the tax calculation on my page. Rob and David suggested this calculation would work, however I am having trouble.
I have already followed the tutorial on how to calculate my total amount with taxes. So now working backwards I want to populate a field to show how much is tax and how much is before tax. i.e.
Subtotal: $100
Tax (25%): $25
Total: $125 (I have this number)
I added a number field above my total in the form and enabled the calculation. A few issues I am noticing
* Should the Total Field be in the Merge Tag drop down list? I can't seem to pick that total field which is what I need to calculate my 25% tax amount (=Total / 5)
* The field on the frontend when the form is published has a dropdown arrow beside it. I would obviously only need this field for information purposes and not for the user to interact with via a dropdown. Is a dropdown the only supported field to make calculations in? The number field that is.
Thanks
Any update on when this goes official?
I´ve been testing calculation price, but It seems doesn't work in IE.
With Chrome and Firefox runs ok but with IE dont make the calculations.
Here is the url, now the site is under construction but you can check the problem: http://www.lienzosymurales.com/vinilos-decorativos/
This problem will be solved in the final version?
@markjones @clicknathan We will hopefully be releasing Gravity Forms v1.6.4 as a final public release later today or tomorrow at the latest barring any major unforeseen issues.
@Fika Please hold off on doing serious calculations until the final v1.6.4 is released within the next 36 hours. There are some bugs related to calculations. The final release will omit fields you can't use, etc. The {total} field is one field that isn't supported due to the complexities involved... Product Fields impact the Total so including the Total in a calculation of the price of the Product Field becomes complex. We do plan on tackling it eventually.
@Achuwoky There are no known bugs with calculations and IE. Our developer who worked on the calculation functionality is a PC user and uses IE. Wait and test with the final v1.6.4 release when it comes out sometime in the next 36 hours and if you have an issue, please post on the support forums or use priority support if you have a Developer License.
@Carl, I don't think dividing one number by another can be considered a "serious calculation" right? Real pity the total field would not be supported as that limits the functionality of this update hugely. That would of been the field most people would of targeted to use the calculations for after reading all the forums. Do you have any sense of when this will be fixed to allow {total}?
thanks
@Fika Dividing a number is not a serious calculation. But as I mentioned, there were bugs with the calculations in the beta release that have been resolved and extensive updates have been made. Wait for the final release, then try... if you have issues, contact support and be sure to show us what your formula looks like.
The Total Field would be nice for calculations. But it is a lot more complex than people realize. Pricing Fields impact the price of the Total. So using the Total in a calculation that impacts the Total brings with it a lot of javascript complexities in how to handle it. Because your calculation is using the total while impacting the total at the same time so there are some calculations happening at the same time (the total calculation and the field calculation) that could cause issues.
But that doesn't mean you can't use the Total. It just means you'd have to calculate the Total using the individual Pricing Fields as part of your formula. So it can still be done, it just can't be done using the Total field merge tag.
It's not a matter of it being fixed. It's not broken. It's simply not a feature that we are including in this release due to the complexities involved. We do plan on implementing it eventually, just not with the initial introduction of the calculation functionality.
hi carl, thanks for the insight...I will defo take a look into it again once released and see if there is a workaround as you suggest not using the total field explicitly for calculating the total...damm wish there was an easier way to just show taxes on a total amount 🙂
@Fika Yea, not being able to use the {total} merge tag makes things a bit more cumbersome as it means you have to calculate up all of the Pricing Fields you are using. So it can still be used to add a tax calculation. It can also be used to apply a discount. If in your formula you multiple your beginning calculation by -1 it will return a negative value of whatever the result of your calculation was. So a negative product price would subtract from the Total.
Great Carl, thanks for the update!
The Gravity Forms v1.6.4 final public release via automatic update has been delayed until Monday, May 1st.
It has not been delayed for development or problem related reasons. Due to travel schedules we will have several members of our team unavailable most of tomorrow (Thursday) and we prefer not to release an automatic update via deployment unless it is some sort of critical patch.
For that reason we have delayed the final release until Monday. Watch for it then.
Thanks for the beta testing everyone!